ClipArt Heaven 2

home *** CD-ROM | disk | FTP | other *** search

/ ClipArt Heaven 2 / ClipArt Heaven 2.iso / utility / vuimage / vuimg.txt < prev

Wrap

Text File | 1993-04-30 | 72KB | 1,620 lines

============================================================================== VUIMAGE(tm) (Version 3.40) (Shareware) GIF*/TIFF/PCX Format Picture Viewer/Printer Copyright (C) 1989-1993 Offe Enterprises. All rights reserved. USERS MANUAL Offe Enterprises, 1163 E. Ogden Ave. #705-131, Naperville, IL 60563 USA Tel: 708-357-6679 Fax: 708-357-6683 BBS: 708-357-6680 1200/2400/9600/14400 8/N/1 ------------------------------------------------------------------------ | At the end of this manual there is a list of changes in this | | version, a list of common problems and solutions, tips on getting the | | best performance from the software, and a list of sources from where | | the latest shareware version can usually be obtained. | ------------------------------------------------------------------------ ******************************* NOTICE ******************************** * * * This program, and all supporting programs and documentation are * * provided "as is" without warranty of any kind, either expressed * * or implied, including but not limited to the implied warranties * * of merchantability and fitness for a particular purpose. In no * * event will Offe Enterprises be liable for any damages arising * * out of the use or inability to use this program and/or all * * supporting programs and documentation. * ************************************************************************* * GIF and "Graphics Interchange Format" are trademarks (tm) of Compuserve, Inc., an H&R block company. PostScript is a trademark of Adobe Systems, Inc. VUIMAGE, VUIMAGE PLUS, TBG and SCRtoPS are trademarks of Offe Enterprises. All prices and other information are subject to change without notice. ============================================================================== FEATURES -------- The main features of VUIMAGE(tm) - GIF/TIFF/PCX display/print software for the IBM PC family are: * Super-fast display or print of: - GIF, GIF89a, PCX and uncompressed bilevel/grayscale TIFF files - compressed bilevel TIFF files (compression type CCITT G3-1D, CCITT Group 4 or Packbits) - 8-bit palette uncompressed TIFF files - certain types of 24-bit color TIFF files - ASCII text files (display only) * Auto/Manual select file type * Optional image pre-loading to conventional or extended memory * Support for a wide variety of display types: - CGA, Hercules, EGA, MCGA, VGA, 6300, Tandy, 8514/A, SuperVGA - VESA SuperVGA driver for all SuperVGA cards that have VESA BIOS support. Supports the following VESA standard modes (if available in card): 800x600x16, 1024x768x16, 1280x1024x16 640x400x256, 640x480x256, 800x600x256, 1024x768x256, 1280x1024x256 - driver for 320x400x256, 360x480x256 and 800x600x16 modes on 100% IBM VGA register compatibles - excellent color rendition in all video modes - various dithering options for two-color video modes - automatic/manual video mode selection capability - display picture within a window on screen * Print images - print entire image or what is on screen - automatic or manual width and height of printed image - print to laserjet, dot-matrix and postscript printers - seven ordered dither plus error diffusion dither options - user selectable page eject at end of print * Pre-scaling, Zoom, Pan and Auto-scale features - many image pre-scaling (scaling image before displaying it) options including various autoscale, no scale, and manual scale from 1% to 999% vertically and horizontally - Zoom in and Zoom out using the "+" and "-" keys - user adjustable Zoom factor - Panning: cursor keys move the screen window over different sections of picture - user adjustable pan amount - autoscale key to autoscale image after it has been displayed * Color Control: adjust brightness, contrast etc. after image is on screen * User-friendly, multiple interfaces - menu-driven: select options and files to view via menus. File(s) can be tagged or specified by file numbers. When a list of files is selected, move forward/backward through the list or continuously repeat the list. List directory alphabetically, by date, by size or by order on disk and list in short, medium or long formats - command-line driven: specify options via command-line parameters - abort single picture or list of pictures in the middle - returns DOS errorlevel value (useful in batch files and when called as a sub-program by other programs) - user selectable menu screen colors - get quick picture info without displaying picture - show brief or detailed image information as each picture is displayed * GIF89a support: Supports plain text, graphics control, comment extensions, restore to background etc. * Utilities: includes utility to convert interlaced GIFs to non-interlaced * Low memory requirements: can work with as little as 180K* of free memory even on very large images * programmable function keys that can be programmed to map to other keys * GIF89a images that use "restore to previous" function need may need more memory for complete restoral to previous. Also, the "image pre-load" feature uses additional conventional or extended memory. ============================================================================== FOR REGISTERED USERS -------------------- Registered users get VUIMAGE PLUS(tm) Version 3.40, our non-shareware version of the program with the following added features: - printed manual - the ability to save the program configuration (i.e. the ability to remember selections made via command-line options or via menu selections) - the ability to display a file or files from the command-line without going through the menu. An image may be left on the screen when the program ends. - ability to display images by specifying a slideshow file. A slideshow file is an ASCII file created by the user containing the names of images to displayed and other parameters. "Looping" is possible within slideshow files. Also, programmable function keys can be used to "branch" to different images in a slideshow file. - ability to display text on top of images at different positions from within a slideshow file - ability to specify the print options (printer type, print size, printer port etc.), zoom factor, pan percentage etc. from the command-line - ability to invert images by pressing the "i" key after the picture has been displayed on the screen - utility "nprint" included to print a directory of images on a laserjet many-to-a-page with or without filenames REGISTRATION ------------ This version of the program is released as shareware. It is not free and is not in the public domain. Private, non-commercial users are requested to register and support its continued development. Registered users get VUIMAGE PLUS(tm) Ver 3.40. To register, please use the order form supplied with this package, or send your name, address and phone number(s) with the registration fee of US $40.00** (outside US, please add $5.00) to: Offe Enterprises, 1163 E. Ogden Ave. #705-131, Naperville, IL 60563 USA Tel: (708)-357-6679, Fax: (708)-357-6683 Any use of VUIMAGE(tm) in a commercial environment is illegal and is strictly prohibited. Commercial users should purchase VUIMAGE PLUS(tm), the non-shareware version. Volume discounts, network licenses and site licenses are available for VUIMAGE PLUS(tm). Contact Offe Enterprises for customized versions and other forms of licensing. DISTRIBUTION ------------ You may make copies of the program files for VUIMAGE(tm) and the documentation VUIMG.TXT (this file) together and distribute them to others, upload to bulletin boards etc. for non-commercial purposes. The program files should not be distributed without the documentation file VUIMG.TXT. All the program files should be distributed together and none of the files should be modified in any way. ============================================================================== OTHER PROGRAMS AVAILABLE FROM OFFE ENTERPRISES: ----------------------------------------------- TBG(tm) - TIFF black&white/grayscale image to GIF/TIFF black&white/ grayscale converter (can reduce large b&w images to smaller grayscale ones for easier viewing, convert TIFF to GIF etc.). Commandline options for non-interactive conversion. TIFCOMB(tm) - Combine many TIFF files into a single TIFF file containing all the images. SCRtoPS(tm) - Dump text and graphics screens (CGA/EGA/VGA) to PostScript printer or capture to Encapsulated PostScript file (including line/box characters). Requires only about 10K of resident memory. Post-Screen(tm) - - This is a post-processing program for SCRtoPS(tm) that allows conversion of foreground/background color information on captured TEXT screens into different background shades of of gray and different foreground thicknesses on the PostScript output and is extremely useful for including screen captures in printed manuals etc. See file PROGRAMS.TXT for more information on these programs. ============================================================================== TABLE OF CONTENTS 1. INSTALLATION AND USAGE 2. PROGRAM CONFIGURATION 3. THE MAIN MENU 3.1 SELECTING THE FILE TYPE 3.2 SETTING THE DISPLAY MODE 3.3 DISPLAYING PICTURE FILES 3.4 TIMEOUT 3.5 ABORT PICTURE 3.6 REPEATING LISTS (CONTINUOUS SLIDE SHOW MODE) 3.7 SELECTING THE DISPLAY DIRECTORY 3.8 DIRECTORY SORT 3.9 IMAGE PRE-LOADING 3.10 SCALING OF PICTURES 3.11 TEXT SCREEN COLORS 4. FUNCTIONS AVAILABLE WHEN A PICTURE IS FULLY ON-SCREEN 4.1 ZOOMING 4.2 PANNING 4.3 BRIGHTNESS 4.4 CONTRAST 4.5 INVERTING THE IMAGE 4.6 PRINTING 4.7 PRINTING INTERLACED GIF FILES 4.8 SUMMARY OF COMMANDS AVAILABLE WHEN A PICTURE IS FULLY ON-SCREEN 5. COMMAND LINE OPTIONS 6. DOS EXIT CODES (ERRORLEVEL) 7. DISPLAY BOARDS and EXTENDED VIDEO MODES/DRIVERS 8. MISCELLANEOUS 8.1 SOME SOURCES WHERE THE LATEST SHAREWARE VERSION IS USUALLY AVAILABLE 8.2 COMMON PROBLEMS AND SOLUTIONS 8.3 TIPS ON OBTAINING MAXIMUM PERFORMANCE 8.4 REVISION HISTORY ============================================================================== 1. INSTALLATION AND USAGE -------------------------- Note: Requires MS-DOS Version 3.0 or later and at least 180K of free memory. 1. FLOPPY DISK Copy all the files from the program disk to another floppy disk. Use this as a working disk - place this disk into drive A:, type "A:" and press return. Go to step 2. HARD DISK Make a new subdirectory. For example, if drive C: is to be used and the subdirectory name desired is \VUIMAGE, enter c: md \vuimage Now make this subdirectory the current directory. In our example, enter cd \vuimage Copy all the files from the program disk to this subdirectory. Go to step 2. 2. Now all the files are in the current drive/directory. To start the program, at the DOS prompt, type the following and press return: vuimg The main menu will be displayed. Also shown will be a list of files in the current directory. The current display mode will be displayed at the bottom left of the screen. The main menu options are displayed at the bottom right of the screen. Press "Q" to quit back to DOS. Go to step 3. 3. The program may be executed any time by changing to the subdirectory that contains the program files and typing "vuimg" as in step 2. However, if execution from ANY drive or subdirectory is desired, the name of the subdirectory that contains the program files should be included in the "PATH" environment variable. (The PATH environment variable contains a list of directories that DOS will search when a command is typed in. Refer to the DOS manual for information on PATH and how to add a sub-directory to the PATH.) ============================================================================== 2. PROGRAM CONFIGURATION ------------------------- VUIMAGE(tm) shareware version users can configure the program using "batch" files. A batch file may be created by typing copy con: v.bat <return> where "v.bat" is the name of the batch file. Now enter the program name along with the drive and full pathname. For example, c:\vuimage\vuimg <return> Then press <ctrl>-Z followed by a <return> to finish creating the batch file (a text editor may also be used to create such a file). Now the program may be started by typing "v" followed by a return. The batch file need not be kept in the same subdirectory as the program files. However, the sub-directory that it is kept in must be part of the "PATH" environment variable. (The PATH environment variable contains a list of directories that DOS will search when a command is typed in. Refer to the DOS manual for information on PATH and how to add a sub-directory to the PATH). After becoming familiar with the command-line options of the program (see later section on command-line options), the batch file may be re-created to include the command-line options that are preferred by the user. This way the program can be "configured" to suit the user's needs. VUIMAGE PLUS(tm) users can configure the program by making selections through the various menus and/or through command-line options, and then saving the configuration using the "z" key within the Options menu. A configuration file "vuimgp.cfg" will be created in the same directory that contains the program files (if the DOS version being used is earlier than DOS 3.0, this file is created in the current directory instead and should be present in the current directory at the time the program is started). If an extended video driver is being used, use the "-v" command-line option to specify a driver when the program is started, before saving the configuration. Once it has been saved, the "-v" option does not have to be specified again. Commandline options can be used to override the saved configuration (see later section on command-line options) for the current session. ============================================================================== 3. THE MAIN MENU ----------------- From the main menu, at the "File(s)" prompt, enter: - "t" to select the file type - GIF, TIFF, PCX, TEXT or AUTO - "m" to change the video display mode - "s" to change the scaling options, and the "image pre-load" options (conventional/extended memory) - "o" to change other user selectable options - "d" to select a different directory/different group of files or to change directory display options - "q" or ESC to quit and go back to DOS. - a list of picture files to be displayed. For example, enter 3,1,5-7,17-14 <return> to display files 3,1,5,6,7,17,16,15,14 from the list (in that order). - One of the arrow keys to select files using the cursor keys. To display a single file, move the cursor bar to the file and press enter. To display a list of files, move to each file and press the space bar to select (mark) the file. Press enter to display the marked files or "/" to continuously repeat the list of files. If there are too many files to fit on one screen, use the PgUp/PgDn keys to see other files. After moving the cursor to a specific file, the "Insert" key may be pressed to obtain quick information about the file. ============================================================================== 3.1 SELECTING THE FILE TYPE ---------------------------- The default file type is "AUTO". To select TIFF, GIF, PCX or TEXT explicitly, press "t" at the main menu prompt. The file type may also be selected from the command-line using the "-t" option (for example, -tpcx will select PCX - see section on command-line options). 3.2 SETTING THE DISPLAY MODE ----------------------------- The program selects a video display mode appropriate for the video adapter and the picture being displayed automatically. The mode is chosen from the CGA/Hercules/EGA/VGA modes present and any modes supported by any extended mode driver that has been loaded (extended mode drivers are selected by the command-line option "-v" - see section "Display Boards and Extended Modes/Drivers" for more details on extended modes). SuperVGA modes are extended modes. If the user desires to select a particular video mode to display the picture instead of the automatically selected mode, this can be done by pressing "m" at the main menu prompt, going into the display mode menu and changing the display mode. An appropriate mode that is supported by the video display board and monitor may be specified. If any extended video mode drivers have been loaded, the extended modes supported by these drivers are also listed. Instead of using the menu, the mode to be used may be specified from the command-line by using the "-m" option (for example, "-m7" will use the EGA 640x350 16-color mode - see section on command-line options). There is also a "BIOS" mode that can be used for extended modes that are unsupported. The display board will need to provide complete BIOS support. Usually the BIOS mode is extremely slow and is useful for testing purposes only. If a video mode is being used that is a 2 color mode, and a color or grayscale image is being viewed, dithering can be used to improve the displayed picture. Use the Options menu to select a type of dithering to be used for 2-color modes. A suggested dither option for 2-color displays is 3 (3x3). To view interlaced files correctly when dithering is used, convert them to non-interlaced files by using the utility NINTLACE.EXE. (See section on interlaced files later). ============================================================================== 3.3 DISPLAYING PICTURE FILES ----------------------------- If there are more files than what fits on the screen, use the PgUp/PgDn keys to show the additional files. To select one file or a list of files to view, use one of the following methods: Method 1: From the main menu, enter the number of the file to be displayed and press return. To display a sequence of files, enter a set of numbers, separated by commas: Example: 3,5 <return> will display file 3 followed by file 5. Enter a starting number and an ending number to display a list of files: Example: 2,5-7 <return> will display files 2, 5, 6 and 7. Example: 2,7-5 <return> will display files 2, 7, 6 and 5. After entering a list of files (or one file) and pressing return, the picture(s) are displayed in sequence. Method 2: Alternately, use the cursor keys to move the cursor bar (initially placed on file 1) to the file that is to be viewed, and press enter to view the file. To select a list of files, "mark" each file by moving the cursor bar to it and then pressing the space bar. When the return key is pressed, the files will be displayed in sequence. *** Methods 3 and 4 are available on VUIMAGE PLUS(tm) only. *** Method 3: The name(s) of the file(s) to be viewed from the command-line may be specified using the "-c" option. See the section on command-line options. The filename may contain wildcard characters "*" and "?". Method 4: A slideshow file created by the user that contains a list of files to be displayed may be specified from the command-line using the "-s" option. See the section on command-line options. Loops can be performed within a slideshow file. Also, function keys may be programmed to branch to different images within the slideshow file. 3.4 TIMEOUT ------------ Each picture is displayed for a default time of 20 seconds. Pressing the PageDown or Return key forces the display to end and move on to the next picture or back to the main menu. Pressing the PageUp or backspace key moves back to the previous picture if a list of pictures is being viewed. The timeout value can be changed from the "Options" menu or from the command- line using the "-t" option - allowed values are between 0 and 43199 seconds (about 12 hours). Setting the value to 43200 causes the timeout to be disabled in which case the picture will continue to be displayed until another key is pressed. Also, if the "@" key is pressed after drawing the picture on screen, the timeout is disabled. Use of the "@" key may also help if a screen grabber program is being used to capture the displayed image. ============================================================================== 3.5 ABORT PICTURE ------------------ Pressing the ESC key while a picture is being drawn aborts that picture. A list of pictures can be aborted by pressing the ESC key twice. 3.6 REPEATING LISTS ( CONTINUOUS SLIDE SHOW MODE ) --------------------------------------------------- When a list of pictures is selected in the main menu, if the list is ended with the forward slash ("/") instead of a <return>, the list will be continuously repeated. To abort this repeated display, press the ESC key twice in quick succession. In a slide show file, a "label" may be created within the file along with a "goto label" statement to create loops. Slideshow files are supported only by VUIMAGE PLUS(tm). 3.7 SELECTING THE DISPLAY DIRECTORY ------------------------------------ From the main menu, the "d" key may be pressed to change the display directory (the directory containing the picture files). The files in this directory will be listed after returning to the main menu. Pressing this key also allows changing the various directory display options. If only a directory name is specified, all files that have an extension of GIF,TIF,PCX or TXT (depending on file type selected) in that directory will be displayed. If listing of other files is desired, enter an appropriate string to be matched. Examples: To list Enter all files in the current directory *.*<return> all files with extension GIF in the current directory *.gif<return> all files with extension GIF or TIF (depending on pics<return> file type) in the subdirectory "pics" of the current directory all files with extension GIF or TIF (depending on \picdir<return> file type) in the subdirectory "picdir" of the root directory all files in the subdirectory "picdir" of the root \picdir\*.*<return> directory. The display directory may also be set from the command-line using the "-dm" option. ============================================================================== 3.8 DIRECTORY SORT ------------------- By default, the directory is sorted alphabetically. If the "d" key is pressed from the main menu, a selection may be made between an alphabetical sort, sort by date, sort by file size or no sort. Also, a selection can be made between a short listing with only file names, a medium listing with file dates and sizes in addition, and a long listing that adds image information. Only the first 1020 files will be sorted in a directory. All others are displayed unsorted. 3.9 IMAGE PRE-LOADING ---------------------- By default, the software will attempt to "pre-load" the image into memory before displaying it. Pre-loaded images usually speed up Zooming and Panning significantly. In slideshow mode, this also allows rapid switching of the screen from one image to the next. Since the entire image has to be pre-loaded before displaying, there is usually a waiting period before the image appears on the screen; hence in some cases it may be desirable to to disable pre-loading. Image pre-loading options may be selected from the "Scale" menu. Images are pre-loaded into conventional memory by default, but pre-loading into extended memory may be specified by the user. An extended memory driver that conforms to the XMS specification needs to be present. If there is insufficient memory, the image is displayed without pre-loading. Image pre-loading requires memory beyond the minimum requirements of 180K. The command-line options "-mn", "-mc" and "-mx" may be used to select the image pre-loading option (see section on command-line options). 3.10 SCALING OF PICTURES ------------------------- There are many scaling options. The default scaling is 1:1 i.e. no scaling. The scaling may be set manually or may be set automatically by the program. There are many auto-scaling selections available. The "auto-scale full screen" option makes the picture "fit" the screen horizontally and vertically. It is also possible to auto-scale with the constraint that the horizontal and vertical scales should be equal. Use the "Scale" menu to change the scaling options. The scaling method may also be selected from the command-line using the "-s" option. 3.11 TEXT SCREEN COLORS ----------------------- The text screen colors may be changed by going into the "Options" menu and pressing "C - Screen Colors ". Use the left/right arrow keys to change the foreground color and the up/down arrow keys to change the background color. (Alternately, use the "f" and "F" keys for foreground and the "b" and "B" keys for background). After selecting the colors desired, note the numbers shown next to each of the colors that was selected - these numbers can be used with the "-kd", "-ko", "-km" and the "-kg" command-line options to start the program with colors that the user prefers. ============================================================================== 4. FUNCTIONS AVAILABLE WHEN A PICTURE IS FULLY ON-SCREEN --------------------------------------------------------- 4.1 ZOOMING ------------ Once a picture is displayed on the screen, zooming in (enlarging) may be performed by using the "+" key. Zooming out (reducing) may be performed by using the "-" key. To autoscale the image to fit the screen exactly, use the "a" key. To reset Zoom/Autoscale, use the "<ctrl>-a" key. The zoom factor may be set from the "Options" menu. 4.2 PANNING ------------ Once a picture is displayed on the screen, the viewing window may be moved around the picture by the use of the following keys (the degree of movement created by the "normal panning" keys can be selected from the "Options" menu): Normal Panning (user selectable degree of movement) down arrow move down right arrow move right up arrow move up left arrow move left Coarse panning ctrl-down arrow move down one screen ctrl-right arrow move right one screen ctrl-up arrow move up one screen ctrl-left arrow move left one screen Pan to Corners ctrl-"Home" move to top left corner of image ctrl-"End" move to bottom left corner of image ctrl-"PgUp" move to top right corner of image ctrl-"PgDn" move to bottom right corner of image Fine Panning alt-u move up one pixel alt-d move down one pixel alt-l move left one pixel alt-r move right one pixel ============================================================================== 4.3 BRIGHTNESS --------------- Once a picture is displayed on the screen, the brightness may be increased by pressing the "b" key and reduced by pressing the "B" key. An overall brightness may also be set from the Options menu. To reset the brightness, press "<ctrl>-b". 4.4 CONTRAST ------------- Once a picture is displayed on the screen, the contrast may be adjusted by pressing the "g" key and the "G" key. An overall contrast adjustment may also be set from the Options menu. To reset the contrast, press "<ctrl>-g". 4.5 INVERTING THE IMAGE ------------------------ Once a picture is displayed on the screen, the image may be inverted by pressing the "i" key (available in VUIMAGE PLUS(tm) only). This is useful for black and white or grayscale images only. Image inversion can be selected during start-up by using the "-iiy" command-line option. ============================================================================== 4.6 PRINTING ------------- When an image is displayed on the screen, that entire image may be printed by pressing the "alt-p" key. To print only the portion of the image displayed on the screen, press the "alt-s" key. Before printing, make sure that the printer port and the type of printer have been correctly selected. This can be done by going into the "Options" menu. For the printer port, "lpt1:","lpt2:","lpt3:","com1:","com2:" or a filename may be specified. The desired size of the print-out may also be set from the Options menu. Any brightness and contrast adjustments that have been made will affect the print output. The output to 2-color printers (most printers) can be dithered so as to obtain a better print-out. The user can choose between no dithering, 2x2, 3x3, 4x2, 4x4, 6x6 or 8x4 dithering by going into the Options menu. The "best" dither setting depends both on the type of image as well as on the printer. For fairly high resolution printers (200x200 dpi or greater), 6x6 or 8x4 dither is suggested for color and grayscale images. For low resolution printers, a 4x2, 3x3 or 2x2 dither may give better results. For bilevel (black & white) images, dithering is automatically disabled. To obtain the best results, it is suggested that the various print dither options be experimented with. 4.7 PRINTING INTERLACED GIF FILES ---------------------------------- Interlaced GIF files are GIF files that contain images that are not drawn top to bottom, but are drawn in four passes over the image area. On each pass, some lines are skipped that are subsequently filled by a following pass. To display interlaced images using dithering in 2-color modes and also to print interlaced images, the image must be converted to a non-interlaced image. This can be done using the utility NINTLACE.EXE by typing: nintlace input.gif output.gif where input.gif is the interlaced GIF file and output.gif is the non- interlaced GIF file to be created. (If the "-n" option is used for NINTLACE.EXE as in "nintlace -n x.gif y.gif", the program does not do this conversion, but will eliminate all unnecessary characters from the end of the file that may have been added as a result of using communications protocols like XMODEM or YMODEM to transfer files). ============================================================================== 4.8 SUMMARY OF COMMANDS AVAILABLE WHEN A PICTURE IS FULLY ON-SCREEN -------------------------------------------------------------------- alt-h Help @ Disable timeout, freeze pic on screen till the enter key is pressed +, - Zoom In, Zoom Out a, ctrl-a Auto-scale current pic to fit screen, reset scales arrow keys Normal pan (down, right, up, left) ctrl-arrow keys Coarse pan ctrl-Home Pan to top left corner ctrl-End Pan to bottom left corner ctrl-PgUp Pan to top right corner ctrl-PgDn Pan to bottom right corner alt-u,d,r,l Fine pan (one pixel) b, B, ctrl-b Increase brightness, decrease brightness, reset brightness g, G, ctrl-g Decrease contrast, increase contrast, reset contrast f cycle through dithers (if being dithered) i invert image (VUIMAGE PLUS(tm) only) alt-p Print entire image alt-s Print screen delete Re-draw picture insert Show picture info PgDn Move to next picture in list PgUp Move to previous picture in list escape Abort the picture/abort the list of pictures ============================================================================== 5.0 COMMAND LINE OPTIONS ------------------------- Most of the options may be set from the command-line instead going through a menu. For example, to start the program with the mode option set to 9 and the scaling option set to 3, enter: vuimg -m9 -s3 The options are specified following "vuimg" or "vuimgp" as applicable, before pressing a return. The available command-line options are listed below: -tfiletype where filetype is "gif", "tif", "pcx" or "auto". Example: -tpcx (display PCX files) -vdrivername where drivername is the name of the extended mode driver appropriate for the video board and monitor. If a version of DOS earlier than 3.0 is being used and the program files are not in the current directory, then the drive and pathname must also be specified. Example (load ATI VGAWonder driver): -vdativ (program files in current dir) -vc:\vuimage\dativ (program files in c:\vuimage) -mmodeindex where modeindex is the number of the mode that would be entered if the selection were to be made from the "Mode" menu. Example: -m9 (set 320x200x256 mode) -mdmodeindex where modeindex is the mode to be force disabled for auto-select -memodeindex where modeindex is the mode to be force enabled for auto-select -mamodeindex where modeindex is the mode to be not forced Example: -md11 (force disable mode 11 for auto-select) -me7 (force enable mode 7 for auto-select) -ma7 (let program decide automatically) -sscaleindex where scaleindex is the number corresponding to the scaling option that would be entered if the selection were to be made from the "Scale" menu. Example: -s3 (set autoscale full screen) -sxhscale where hscale is the horizontal scale value (1% to 999%). This option should be used only if manual scaling is selected. Example: -sx200 (set horizontal scale to 200%) -syvscale where vscale is the vertical scale value (1% to 999%). This option should be used only if manual scaling is selected. Example: -sy50 (set vertical scale to 50%) -dmdirectory where directory is a directory name (or file matching string) Example: -dmC:\PICS (show files in C:\PICS directory) -dmc:\pics\*.pcx (show files that match c:\pics\*.pcx) -dssorttype where "sorttype" is 0 for no directory sort, 1 for alphabetical sort, 2 for sort by date and 3 for sort by file size. Example: -ds2 (sort directory by date) -dllisttype where "listtype" is 0 for short, 1 for medium directory listing and 2 for long directory listing. Example: -dl1 (show medium directory listing) -dddateform where "dateform" is 0 for month-day-year (US) format, 1 for day-month-year (non-US) format. Example: -dd1 (DD-MM-YY format) -ttimeout where timeout is the number of seconds to display each picture. Example: -t40 (set timeout to 40 seconds) -by enables the beep at the end of a picture -bn disables the beep at the end of the picture Example: -bn (disable beep) -bbrightness where brightness is the brightness value (100 is nominal) Example: -b120 (set brightness to 120%) -bccontrast where contrast is the contrast value (100 is nominal) Example: -bc80 (set contrast to 80) -kddircolor where dircolor is the color number for the filenames -kofncolor fncolor is the color number for the file numbers -kmmodcolor modcolor is the color number for the display mode -kggencolor gencolor is the color number for general text To find the color numbers for favorite colors, first go into the "Options" menu and select the favorite colors. The corresponding color numbers are also displayed. Example: -kd78 (filenames in yellow on a red background) -ko10 (filenumbers in bright green on black) -km4 (video mode in red on black) -kg14 (general text in yellow on black) -fddithertype where dithertype is the number that would be entered if the "display dither type" selection were to be made from the "Options" menu. Example: -fd3 (dither 2-color displays using 3x3 matrix) -fpdithertype where dithertype is the number that would be entered if the "print dither type" selection were to be made from the "Options" menu. Example: -fp4 (dither 2-color printers using 4x4 matrix) -iby show brief info as pic is displayed (filename, image size) -ibn do not show brief info (-ibn) -idy show detailed info as pic is displayed, -idn do not show detailed info -iiy invert the image (useful only for black/white or grayscale) -iin do not invert the image -igy show GIF89a comments -ign do not show GIF89a comments -woxoffsetx where "offsetx" is the horizontal offset of window, -woyoffsety "offsety" is the vertical offset of window, -wxsizex "sizex" is the horizontal window size, -wysizey and "sizey" is the vertical window size of a window on the screen to display the picture in. All dimensions are in number of pixels. Example: -wox100 -woy50 -wx240 -wy160 (display in a window of size 240x160, offset by 100x50) -wcy center image within display window -wcn place image at top left corner of display window -ul0 unit is inches (for print size etc.). -ul1 unit is cm. -mx pre-load into extended memory (XMS) -mc pre-load into conventional memory -mn do not pre-load -edry the default mode when editing (changing selections) is replace -edrn the default mode when editing (changing selections) is insert (*** The following options are available only in VUIMAGE PLUS(tm) ***) -pprinternum where printernum is the number that would be entered if the "printer type" selection were to be made from the "Options" menu. Example: -p1 (select EPSON FX80/100 printer) -pddevicename where devicename is the printer device (lpt1:, lpt2:, lpt3:, com1:, com2: or filename). Example: -pdlpt1: (send output to lpt1:) -pdvuimg.prn (send output to file vuimg.prn) -pxwidth where width is the width of the printed image in 1/100 inches/cm Example: -px904 (print image width=9.04 inches/cm) -pyheight where height is the height of the printed image in 1/100 inches/cm Example: -py1200 (print image height=12.00 inches/cm) -pttmarg on a very limited set of printers, these options can be used -pllmarg to set the top margin (tmarg) and left margin (lmarg) for the printed image. -pcy disable the print capability -pcn enable the print capability -pfy perform page eject after print -pfn do not do page eject after print -zfzoomfactor where "zoomfactor" is the Zoom Factor in percentage. Example: -zf200 (sets Zoom to 200%) -zppanpercent where "panpercent" is the percentage (of the screen) to move when one of the "normal panning" keys (down,up,right and left arrow) is pressed. Example: -zp4 (move by 4%) -dcdir where "dir" is the drive and pathname of files that are specified by the "-c" or "-cp" options (below). -c files disable the menus and display (-c) or display and print (-cp) -cp files the files specified. The filenames should include the entire pathname unless a path has been specified using the "-dc" command (above). This should be the last option entered on the command-line. The filename may contain wild card characters "?" and "*". Any directory name entered with the "-dm" option will be ignored. Examples: -c somefile.gif -c \pics\a*.gif \pics\m.gif -dc\pics\ -c a*.gif m.gif -cp image.tif -lqn do not quit after the last image when a series of images are displayed using the "-c" option. -li leave the last image on the screen when the program ends. Valid only when the -c option is used. Useful when called as a sub-program by another program. -ly do not reset the video mode or clear the screen between images. Valid only when the -c option is used. This option is useful only if the images being viewed are close enough in size, resolution and colors that the video mode and the palette will be the same for the images. Not recommended for use unless this is the case. It is recommended that an appropriate video mode should be specified instead of using auto-select. -ln clear the screen between images (reverse effect of "-ly"). -s specify the name of a slideshow file created by the user using a text editor that contains a list of files to be shown. This file may also contain other command-line options. For example, enter vuimgp -s slidshow.1 where the file "slidshow.1" contains -------------------------- | -m0 -s3 | <- start-up parameters | -c file1.gif | <- show file1.gif | -m8 -c file2.gif | <- show file2.gif | -s1 -m0 -c file3.gif | <- show file3.gif | -q | -------------------------- The lines within the file are executed in sequence. PgDn and PgUp keys may be used to go forwards and backwards in the list of images during display. The "-cp" and "-s" options should not be used within this file. However, it is possible to create effects such as multiple images on one screen by using the "-ly" option along with the windowing options "-wx, -wy, -wox, -woy". A specific video mode should be selected using the "-m" option if this is attempted. -ctn string display string on the screen. Used only in a slideshow file after displaying an image first. "n" is a number from 1 to 9 indicating the position of the string on the screen. -cc1 string send the string to the printer. -q Exit from the program (useful only in slideshow files) ============================================================================== 6.0 DOS EXIT CODES (ERRORLEVEL) -------------------------------- The return codes generated by the program that may be tested in a batch file are: 0 - no error 1 - command-line option error 2 - the -c option was used without specifying a file 3 - file not found or invalid filename 12 - slideshow file not specified 13 - Error opening the slideshow file 14 - command-line option error within the slideshow file ============================================================================== 7. DISPLAY BOARDS and EXTENDED VIDEO MODES/DRIVERS --------------------------------------------------- If the program does not work properly with your graphics board in standard CGA/EGA/VGA resolutions, refer to the instructions for the board - the board may not be installed properly, or there may be a need to load a software driver that came with it (via the CONFIG.SYS or AUTOEXEC.BAT file). Most VGA compatible graphics boards support even higher resolutions than standard VGA, for example, 640x480 in 256 colors or 800x600 in 16 colors. These are sometimes referred to as SuperVGA modes or extended modes. Additional video drivers that support these extended modes are included with the program. These drivers have filenames with the extension ".VDR" and are listed later in this section. Once a suitable driver has been determined for the video board from this list, it can be loaded using the "-v" command-line option. For example: vuimg -vdtsng4 <return> loads the Tseng 4000 driver. Once loaded, saving the configuration in VUIMAGE PLUS(tm) will also save the information about which driver is to be loaded. Typically, extended modes vary from board to board. Refer to the graphics board manual to see what extended modes are supported. See the "Extended Mode Drivers Included" list at the end of this section to see which driver is suitable for your board. Once a suitable driver is determined, the additional modes supported by the driver can be read from the "Extended Modes Supported by the Drivers" section. Some of the modes listed may not be available in your graphics board, and some may require that more memory be added to the board before becoming available. The unavailable modes can be and SHOULD BE disabled using the "-md" command-line option (or from the "Mode" menu) before attempting to use the driver, so that the "auto-select video mode" function does not try to select these modes. Saving the configuration in VUIMAGE PLUS(tm) also saves the information about the modes that have been disabled. There is a SuperVGA standard known as the VESA SuperVGA standard that is now supported by many or most of the SuperVGA boards. If your board supports this standard, then you can take advantage of the VESA driver "dvesa.vdr". Even if one of the other drivers supports your board, use of the "dvesa" driver is recommended if your board has VESA support (this does not apply to boards that can use one of the 8514 drivers). In order for your board to support the VESA standard, you may need to load a TSR program (such as VESA.COM) via your AUTOEXEC.BAT file or a device driver program (such as VESA.SYS) via the CONFIG.SYS file. These programs are either shipped along with the boards or are available from the manufacturers of the boards. Refer to the documentation that comes with the board or to its manufacturer. If an extended mode driver is not available that supports your board, you may still be able to display in an extended mode if your BIOS for the board has full support for the extended mode. To use the BIOS to display in extended modes, you need to know the mode number, the number of columns, the number of rows, and the number of colors for the extended mode. Refer to the manual for your graphics board for this information. Not all boards come with BIOS that support the extended modes completely. Installing any BIOS drivers that come with your board may help. Display done through the BIOS is usually extremely slow and is useful only for testing purposes. If you have a plain VGA card with no SuperVGA modes, you may still be able to get higher resolutions (320x400x256, 360x480x256, 800x600x16, 400x600x256) using the DNVGA driver. ============================================================================== Extended Mode Drivers (SuperVGA drivers) included: ------------------------------------------------- Note: Some of the modes listed may not be available in your specific card. These should be disabled (see section above). Additional drivers may be available from Offe Enterprises. Display board Driver that may support board ----------------------------------------- ----------------------------- Boards that support the VESA SuperVGA DVESA standard and has VESA BIOS installed 8514/A AI Compatibles (AI must be loaded) D8514AI 8514/A 100% register compatibles D8514R Orchid Fahrenheit 1280 (S3 86C911 Chip Set) DS3911 (Many of the following cards come with VESA BIOS support in the form of a "TSR" that can be loaded into memory. In such cases, this TSR should be loaded, and the "DVESA" driver specified to VUIMAGE(tm) instead of the driver listed below. Ahead Systems VGA Wizard DAHEADB AST VGA cards DPVGA ATI Prism Elite DTRID ATI VGAWonder DATIV ATI Graphics Ultra (SuperVGA modes) DATIV, D8514R or D8514AI** ATI Graphics Vantage (SuperVGA modes) DATIV, D8514R or D8514AI** AT&T VDC600 DPVGA BOCA w/Tseng 4000 Chip Set DTSNG4 Cardinal 600 VGA DCHT Chips & Technologies DCHT Everex EV673 DE673 Everex EV678 DE678 Genoa 6400 DORCH Genoa 5400 DORCH Genoa 5300 DORCH Hercules Graphics Station DHGS IMTEC DTRID LOGIX DTRID MAXXON DTRID Northgate Pro DV7VRAM Oak Technologies DOAK Orchid Fahrenheit 1280 DS3911 Orchid ProDesigner DORCH Orchid ProDesigner II (Tseng 4000) DTSNG4 Paradise VGA Professional DPVGA Paradise Image Sharpener (NVGA-P1D) DVESA Sigma VGA cards DORCH Standard IBM VGA & register compatibles with multisync monitors DNVGA Older STB VGA cards DORCH STB PowerGraph (Tseng 4000) DSTBPG, DVESA or D8514AI** Tandy 1000 (320x200x16) DTANDY Trident Video cards DTRID Video-7 Fastwrite DV7FW Video-7 1024i DV71024 Video-7 VRAM DV7VRAM Other Chips&Technologies chip set cards DCHT Other Paradise VGA cards DPVGA Other Trident chip set cards DTRID Other Tseng 3000 chip set cards DORCH Other Tseng 4000 chip set cards DTSNG4 Oak Technologies chip set cards DOAK NCR chip set cards DNCR Cirrus chip set cards DCIRR S3 86C911 chip set cards DS3911 IBM PS/2 25SX/35/40/56/57 DVESA* * the VESA driver (TSR) that comes with the board, or available from the manufacturer, must be loaded. ** the AI driver that comes with the board must be loaded. If your board is not listed, contact the board manufacturer or Offe Enterprises to see if any of the extended modes of one of the supplied drivers may work. All extended modes available on a board may not be supported by the driver. All extended modes supported by the driver may not be available on your board. Some may simply be unavailable, some may require more memory. MODES SUPPORTED BY THE DRIVER THAT ARE NOT AVAILABLE IN YOUR CARD OR THAT ARE NOT SUPPORTED BY YOUR MONITOR SHOULD BE DISABLED USING THE "-md" COMMAND-LINE OPTION. Extended Modes Supported by the Drivers (mode numbers in decimal and hex) DVESA Mode 256 (100h) 640 x 400 x 256 colors Mode 257 (101h) 640 x 480 x 256 colors Mode 258 (102h) 800 x 600 x 16 colors Mode 259 (103h) 800 x 600 x 256 colors Mode 260 (104h) 1024 x 768 x 16 colors Mode 261 (105h) 1024 x 768 x 256 colors Mode 262 (106h) 1280 x 1024 x 16 colors Mode 263 (107h) 1280 x 1024 x 256 colors D8514AI (requires AI to be loaded via "hdiload" or other program) D8514R (8514/A 100% register compatibles) 640 x 480 x 16 colors ( 512K) 1024 x 768 x 16 colors ( 512K) 640 x 480 x 256 colors (1 MEG) 1024 x 768 x 256 colors (1 MEG) DAHEADB Mode 106 (6Ah) 800 x 600 x 16 colors Mode 113 (71h) 800 x 600 x 16 colors Mode 116 (74h) 1024 x 768 x 16 colors Mode 96 (60h) 640 x 400 x 256 colors Mode 97 (61h) 640 x 480 x 256 colors Mode 98 (62h) 800 x 600 x 256 colors Mode 99 (63h) 1024 x 768 x 256 colors DATIV Mode 84 (54h) 800 x 600 x 16 colors Mode 97 (61h) 640 x 400 x 256 colors Mode 98 (62h) 640 x 480 x 256 colors Mode 99 (63h) 800 x 600 x 256 colors Mode 101 (65h) 1024 x 768 x 16 colors Mode 85 (55h) 1024 x 768 x 16 colors DCHT Mode 112 (70h) 800 x 600 x 16 colors Mode 114 (72h) 1024 x 768 x 16 colors Mode 120 (78h) 640 x 400 x 256 colors Mode 121 (79h) 640 x 480 x 256 colors Mode 128 (7bh) 800 x 600 x 256 colors DCIRR Mode 99 (63h) 720 x 540 x 16 colors Mode 100 (64h) 800 x 600 x 16 colors Mode 106 (6Ah) 800 x 600 x 16 colors Mode 97 (61h) 640 x 400 x 16 colors (GD5320) Mode 98 (62h) 640 x 450 x 16 colors (GD5320) Mode 112 (70h) 360 x 480 x 256 colors (GD5320) Mode 113 (71h) 528 x 400 x 256 colors (GD5320) Mode 114 (72h) 528 x 480 x 256 colors (GD5320) Mode 116 (74h) 320 x 240 x 256 colors (GD5320) Mode 117 (75h) 640 x 400 x 256 colors (GD5320) DE673 Submode 19 (13h) 640 x 350 x 256 colors Submode 20 (14h) 640 x 400 x 256 colors Submode 21 (15h) 512 x 480 x 256 colors DE678 Submode 49 (31h) 640 x 400 x 256 colors Submode 50 (32h) 512 x 480 x 256 colors Submode 77 (4dh) 640 x 480 x 256 colors Submode 78 (4eh) 800 x 600 x 256 colors DHGS 640 x 480 x 256 colors 800 x 600 x 256 colors 1024 x 768 x 256 colors DNCR Mode 88 (58h) 800 x 600 x 16 colors Mode 93 (5Dh) 1024 x 768 x 16 colors Mode 94 (5Eh) 640 x 400 x 256 colors Mode 95 (5Fh) 640 x 480 x 256 colors Mode 92 (5Ch) 800 x 600 x 256 colors DNVGA ------- 320 x 400 x 256 colors ------- 360 x 480 x 256 colors ------- 800 x 600 x 16 colors ------- 400 x 600 x 256 colors DOAK Mode 82 (52h) 800 x 600 x 16 colors Mode 83 (53h) 640 x 480 x 256 colors Mode 84 (54h) 800 x 600 x 256 colors Mode 86 (56h) 1024 x 768 x 16 colors DORCH Mode 41 (29h) 800 x 600 x 16 colors Mode 45 (2Dh) 640 x 350 x 256 colors Mode 46 (2Eh) 640 x 480 x 256 colors Mode 47 (2Fh) 720 x 512 x 256 colors Mode 48 (30h) 800 x 600 x 256 colors Mode 55 (37h) 1024 x 768 x 16 colors DPVGA Mode 88 (58h) 800 x 600 x 16 colors Mode 94 (5Eh) 640 x 400 x 256 colors Mode 95 (5Fh) 640 x 480 x 256 colors DS3911 640 x 480 x 256 colors 800 x 600 x 256 colors 1024 x 768 x 256 colors DTANDY Mode 9 (09h) 320 x 200 x 16 colors DTRID Mode 91 (5Bh) 800 x 600 x 16 colors Mode 92 (5Ch) 640 x 400 x 256 colors Mode 93 (5Dh) 640 x 480 x 256 colors Mode 94 (5Eh) 800 x 600 x 256 colors Mode 95 (5Fh) 1024 x 768 x 16 colors Mode 98 (62h) 1024 x 768 x 256 colors DTSNG4, DSTBPG Mode 41 (29h) 800 x 600 x 16 colors Mode 55 (37h) 1024 x 768 x 16 colors Mode 45 (2dh) 640 x 350 x 256 colors Mode 47 (2fh) 640 x 400 x 256 colors (DTSNG4) Mode 120 (78h) 640 x 400 x 256 colors (DSTBPG) Mode 46 (2eh) 640 x 480 x 256 colors Mode 48 (30h) 800 x 600 x 256 colors Mode 56 (38h) 1024 x 768 x 256 colors DV71024 Mode 98 (62h) 800 x 600 x 16 colors Mode 101 (65h) 1024 x 768 x 16 colors Mode 102 (66h) 640 x 400 x 256 colors Mode 103 (67h) 640 x 480 x 256 colors DV7FW Mode 98 (62h) 800 x 600 x 16 colors Mode 102 (66h) 640 x 400 x 256 colors Mode 103 (67h) 640 x 480 x 256 colors DV7VRAM Mode 98 (62h) 800 x 600 x 16 colors Mode 101 (65h) 1024 x 768 x 16 colors Mode 102 (66h) 640 x 400 x 256 colors Mode 103 (67h) 640 x 480 x 256 colors Mode 105 (69h) 800 x 600 x 256 colors ============================================================================== 8. MISCELLANEOUS ----------------- 8.1 SOME SOURCES WHERE THE LATEST SHAREWARE VERSION IS USUALLY AVAILABLE ------------------------------------------------------------------------- 1. The Offe Enterprises BBS - 708-357-6680 Files Section - Filename VUIMGxyz.* where xyz is the version number. 2. Compuserve - PICS (GRAPHICS SUPPORT) forum, library 3. - Enter "browse vuim*.*" in library 3 to list. 3. EXEC-PC BBS - "Free download area for all callers" sub-section of the Files section of the BBS - (414)-789-4210 - Filename VUIMGxyz.* where xyz is the version number. 8.2 COMMON PROBLEMS AND SOLUTIONS ---------------------------------- 1. While attempting to display a picture, a) the screen dims, or b) the screen changes color, or c) nothing happens and the picture is not displayed. After some time, a beep is heard and if the return key is pressed, the main menu returns. The most likely cause of the problem is that a video mode that is not available in your video adapter is being used. This usually happens when the "auto-select video mode" feature is on, and an extended video driver is specified but all of the modes supported by the driver are not available. To solve the problem, go to the "Mode" menu from the main menu, and determine what modes are NOT available by following this procedure. a) Select each of the modes marked by an asterisk manually b) Try to display a picture The modes that do not work should be disabled using the "-md" command-line option (see section on "DISPLAY BOARDS and EXTENDED VIDEO MODES/DRIVERS" for more information). VUIMAGE PLUS(tm) users need to specify this through the command-line option only once if the configuration is subsequently saved. 2. How do I print ? Go to the Options menu and select the printer type and printer port, and the print dither type. Once a picture has been displayed on the screen, press the "alt-p" key to print the entire image, or "alt-s" to print what is currently on screen. For more information, read the sub-section "PRINTING". 3. The printed image appears in four bands of different heights. Most likely, you are trying to print an interlaced GIF file. Read the sub-section titled "PRINTING INTERLACED GIF FILES". 4. My printed image quality could be better. You may be using a print dither inappropriate for the image. See sub-section on "PRINTING". 5. I would like to see a specific feature added to the program. You can write or call Offe Enterprises. Features requested by larger number of registered users are given higher priority. (Note, however, that no guarantee can be given that the feature will be incorporated in a future release.) 6. While starting up the program, I get an error message about "STACK" such as "Stack Overflow" This could be due to two reasons. There may not be sufficient memory to run the program, or, you could have a large amount of memory used up by "Environment Variables". Some shell replacements for the file "COMMAND.COM", as well as COMMAND.COM files modified to specifically do this, allow a large amount of memory to be used for environment variables. Often it is easy to reduce the memory taken up this way by the use of batch files which create only temporary environment variables (the variables are set at the beginning of the batch file, and destroyed at the end of the batch file). Note: Environment Variables are variables that are set using the "SET" command, such as "SET HOME=C:\DATADIR\MYNAME". ============================================================================== 8.3 TIPS ON OBTAINING MAXIMUM PERFORMANCE ------------------------------------------ 1. You can obtain higher quality images on the screen by the use of SuperVGA, 8514/A or other high resolution graphics board for which a driver is included (see section on DISPLAY BOARDS and EXTENDED VIDEO MODES/DRIVERS). A board that provides VESA SuperVGA compatibility (such a board comes with VESA Bios support) or 8514/A AI compatibility (such a board comes with an AI driver) may give the best performance with VUIMAGE(tm). 2. If your board has VESA Bios or 8514/A AI compatibility, use it in the VESA SuperVGA or 8514/A AI compatible mode (follow instructions that came with your board on how to do this), and specify either the "dvesa" or "d8514ai" driver as appropriate EVEN IF one of the other drivers will work. 3. Make sure to disable all SuperVGA video modes that are provided by a driver but are unavailable in your system. Also, if two video modes are available in the same resolution but one is 16-color and the other is 256-color (example: 800x600x16 and 800x600x256), disable the 16-color mode. 4. Install extended memory in the machine, if possible, and specify to VUIMAGE(tm) that extended memory is to be used (this can be done from the "Scale" menu). More extended memory will be required for larger images. At least two megabytes is suggested. 5. Select a "pan percentage" from the Options menu that is suitable for your system, if you "pan" over images larger than the screen. 6. When printing, choose a "print dither" option that is suitable for the image and the printer. ============================================================================== 8.4 REVISION HISTORY --------------------- Additions/Changes from Version 3.36 to Version 3.40: - Error diffusion dither added as one of the dither options - Postscript support added. For postscript output only, option "-pa0" selects portrait, "-pa1" selects landscape, "-phheight" sets the paper height (example -ph1100 sets paper height to 11.00) Additions/Changes from Version 3.31 to Version 3.36: - made the default extended video driver "dvesa" instead of none. - changed "pan to corner" keys from shift-Home/End/PgUp/PgDn to ctrl-Home/End/PgUp/PgDn - changed "coarse pan" keys from shift-arrow keys to ctrl-arrow keys - changed "fine pan" keys from "U","D","R","L" to alt-u,alt-d,alt-r,alt-l - changed "print whole image" key from "p" to key "alt-p" - changed the "help" key from "h" to key "alt-h" - keys 'd','u','r','l' no longer function as pan keys - Added support for Laserjet IV (600 dpi) - Added ability to print what is currently on screen after zooming etc. rather than the whole image (uses the "alt-s" key) - Added support for Cirrus chip set 6420 in DCIRR.VDR - If the "print width" is set to 0.0, print dot-for-dot is enabled. - If the "print height" is set to 0.0, print height is set automatically. - For bilevel images, dithering is automatically turned off. - Added a "print progress" indicator - The command-line parameters are no longer case sensitive. In order to accomplish this, some of the command-line parameters had to be changed as follows. OLD NEW --- --- -cd# -kd# (dir color) -co# -ko# (fn color) -cm# -km# (mod color) -cg# -kg# (gen color) -d -dm (directory mask/directory name) The following apply to VUIMAGE PLUS(tm) only -L -li (leave image on screen when ending) -l -ly (do not clear screen between images) -pDy -pcy (disable print) -pDn -pcn (enable print) - added following to VUIMAGE PLUS(tm): - added "programmable" function keys: function keys can be programmed to "map" to other keys, or can be programmed to "branch" to different images in a slideshow file - added command-line options "-pfn" and "-pfy" to disable/enable page eject at the end of printing - ability to display user-specified text on top of the image (or next to image if image is displayed on only a portion of the screen). This is done via a slideshow file, using the options "-ct1" through "-ct9". - added command-line option "-ln" that reverses the effect of option "-ly" - added command-line option "-lpn" that reverses the effect of option "-lp" - added command-line option "-cc1" to send a string to the printer - Semicolons can be used to create comments within slideshow files - When displaying files from the command-line, a directory may be specified using the "-dc" option. Example: "vuimgp -dcC:\PICS\ -c 1.gif 2.gif" will show C:\PICS\1.gif and C:\PICS\2.gif. - added command-line option "-lqn" to prevent exiting after the last image when a series of files are specified on the command-line. - The utility "nprint" is now included that can be used to print all the files in a subdirectory to a laserjet with multiple images (thumbnail) to a page (with or without filenames) Additions/Changes from Version 3.30 to Version 3.31: - display is faster in the EGA & VGA 2-color and 16-color modes - handles compressed bilevel TIFF files (compression type CCITT G3-1D, CCITT Group 4 or Packbits) - the way GIF89a comments are displayed has changed - the comments are now all shown at the end of the image. To prevent the comments from being displayed, use the "-ign" command-line option.